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ABSTRACT 


This is a highly graphic user-oriented interactive 
software product which will assist the user to become more 
proficient at recognizing and employing Nevy signal flags 
and pennants whicn are used for visual ccmmunicaticns 
between naval vessels of all types. A tutorial portion of 
the program has been designed with a number of cptions, 
thereby allowing a user to tailor a recognition program to 
satisfy specific learning requirements. The program is also 
capable of graphically displaying any grouping of flags and 
pennants chosen by the user in flaghoist order. When the 
flags and pennants are arranged in accordance with the pro- 
cedural doctrine set forth in the ALLIED MARITIME TACTICAL 
SIGNAL BOOK, ATP 1(B), Volume II, the program demonstrates 
the capability of decoding the displayed signal into its 
predetermined meaning. The current program is resident in 
the Secure Command, Centrol and Communications Exercise La- 


boratory (C3 Lab) at the Navy Postgraduate School. 
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I. INTRODUCTION 


A. BACKGROUND 


Most visual communications systems presently in use on 
board United States Navy ships have been employed in much 
the same manner for centuries. Their continued use is evi- 
dence of their utility and significance. Of the visual sys- 
tems incorporated today, flaghoist is the one most fre- 
quently used, even though its use is limited to the hours of 
daylight. Flaghoist is commonly used for close-in communi- 
Sabions in the fleet. 

Flaghoist involves the use of coded flags and oveé€nnants. 
Usually these flags and pennants are displayed prominently 
On a hoist running up to a yardarm on the ship’s mast. Each 
"flag (to include pennants) represents a letter, a numeral, 
Or a designated special meaning. One flag or a grouping of 
flegs in a prescribed order constitute a signal. In gen- 
eral, a flaghoist signal ensures a more uniform execution of 
a maneuver than any other system of visual communications. 

Flaghoist signaling provides a rapid and accurate system 
of passing tactical and administrative information. 
Flaghoist is rapid because, by hoisting and displaying one 
or more flags that have a predetermined meaning, a ship can 


communicate simultaneously with all ships in company. It is 





mumeeccurete system for the reason thet the receivers of the 
Signal are required to rereat the signal, flag for flag, al- 
lowing the originétor to immediately confirm that those sent 
the signal received it correctly. In addition, flaghoist 
Signaling aptly meets many security previsions, which can be 
considered a prime requisite for naval communications. Not 
coly is tne range limited, the meéening of the signal itself 
Can only ve found in a clessified signal publication. TD 
nally, flaghoist signeling may be the only means of expedi- 
tious tactical communications during emergency conditions 
when any scrt of electronic emissions from a ship may te 
prohibited for the very safety of that Ship. 

In flaghoist signaling, the U. S. Navy uses 68 flags. 
These include the international alphebet flags (26), numerel 
vennents (1@), and a Code/Answer pennant; a set of numeral 
flags (18), special flags end pennants (17); end four sub- 
stitutes, or repeaters. Each alphabet flag has the phonetic 
name of the letter it represents. A numeral FLAG takes the 
name of the numeral it represents; numeral PENNANTS are only 
Mmeeo in cell signs. Special flags and pennants are used in 
tactical maneuvers tc direct changes te speed, positicn, 
fomese, end formation, to indicate end identify units, end 
morespecialized purposes. In addition to the flags used for 
signaling, there is the tackline or tack. The tackline is 
used to separate flags or groups of flags which, if not 


separeted, could convey another meaning from that intended. 





In rost cases the tack is included in the signal to avoid 
any ambizuity. 

A flaghoist signel (messege) consists of two yparts: 
neading and text. The heading may be specified by hoisting a 
visual call sign; numerals in the call of the heading are 
numeral pennants. More frequently, the heading is implied, 
and ell thet is hoisted is the text portion of the signal. 
The text usually is made up of flag combinations extracted 
from tne ALLIED MARITIME TACTICAL SIGNAL EOOK, ATP 1(B), 
Volume II. A Signal is read” by noting the flag positions 
Starting {rem the top most outboard flag down the salyard to 
the bottom flag, then to the next most outboerd top fleg 
down to the dvottom, etc., etc. A display is a complete 
Signéel, whether on ore halyard cr on two or mere. 

ATP 1(B), Vol. II is the origin of most tactical commun- 
ications between allied naval units. The signal vocabulary 
of this publication is collected into charters and arranged 
under headings for ease f reference. Chanter 1 ccntains 
general instructions for use of the pook. Chapter <2 contains 
Single flag and pennant signals. Chapter 5 contains emergen- 
cy alarm and emergency action signals. Chanters 4 throvgh @ 
contain maneuvering signals which utilize a special pennant. 
Chapters 138 throvegh 31 contain the main signal vocabulary, 
which consists cf operational and administrative signals ar- 
maneed in alpnabetical order under appropriate headings. 


Chapter 52 consists cf? supplementary tables which are used 


1d 





to augment and modify the meaning of certain basic groups. 
The signal vocabulary chapters are followed by en extensive 
Signal index provided to assist the user in finding the 
desired groups when encoding signals. The overall security 
classification of ATP 1(B), Vol. II is NATO-CONFIDENTIAL, 
which reauires a NATO special clearance (for confidential 
material) in order to be able to view its contents. 

moesvo the classification of the ALLIED MARITIME TACTI- 
CAL SIGNAL BOOK and the sheer number of possible combina- 
tions of messages that can te formulated, all enlisted per- 
sonnel and officers responsible for decoding flaghoist sig- 
nals are actively discouraged from trying to memorize any 
Signal contained in the publication. Even if an individual 
“thinks he knows the meaning of a group of flags, there is 
a Standing requirement to look the signal up in the publica- 
bhon vefore reporting the meaning to a senior. 

The enlisted rating which is responsible for visual ccm- 
munications on odoard a ship is that of Signalman. Besides 
Other duty responsibilities Signalman personnel ere required 
to acquire and maintain a solid background and knowledge in 
procedures, methods, and rules pertaining to flaghoist ccm- 
munications. Fundamental to this tasking is a proficiency in 
readily identifying all signal flags and pennants’ used. 
Signalman ‘A School presently devotes five hours of in- 
Structional time to the learning of the slgnal flags. 


Within the officer ranks, every prospective Surface Warfare 


shal 





Naval Officer receives a minimum of four hovrs of formel 


meesesrecom instructicn and ovractice in signal flag recceni- 
Meeeewesices the time set aside in the classroom to learr 
the identity cf all the flags and pennants mcst individuals 
(enlisted and officers) who have to learn them require an 
additional minirum Semcevene UC TEN = ==nouns tO become 
“moderately proficient with a fair amcvunt of retenticn 
Stravility. 

The primary aid currently used by ean individual in 
learning and studying the flags outside the classrccm is the 
“Navy and International Code Flag Cards , device number 
ees this is a product cf tne U.S.Naval Training Device 
Center produced by Brown and Bigelow (FSN:22-€910-514-2232). 
The flash-cards device consists of 75 playing-card-sized 
cards with a color pleture of a fleg or pennant on one side, 


and the name of the ?lag or pennant on the other. 
fee OBJECTIVE 


imesmdin Objective of this study was to produce a sim- 
ple, user oriented, yet all inclusive and foolproof computer 
rrogram routine which would be able to teach a user. the 
Signal flags and pennants, and in addition, have tne carpa- 
bility to decode such flags and pennants displayed in 
groups in accordance with standard prccedures delineated in 


per (EB), Mol. II. 
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In striving te realize the above stated objective other 
less significant objectives were achieved in the process. 


Among these objectives were: 


(1) To incorporate the C3 Laboratory--its assets and in- 
herent capabilities--as an integral and major part o? 


the thesis itself; 


(2) To actively apply various programming techniques and 
design principles expounded in variovs academic 
courses to a specific real-world and Service related 


mapic of interest; and, 


(3) To create a product which has the potential to be a 


fetes Conver: bution to the U.S. Navy. 
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II. PROGRAMMING OBJECTIVES AND DESIGN PRINCIPLES 


The graphic tutorial and decoding program for Navy sig- 
nel flegs and pennants which satisfies the above objective 
was designed to be used on a PDP 11/72 computer located in 
the Secure Command, Control and Communicetions Exercise La- 
boratory (C3 Lab), at the Navy Postgraduate School. The C3 
Lab wes developed for use as a research, test and evalua- 
tion, and experimentation facility. Designated a Remote 
Site Module (RSM), the C3 Lab is part of a secure computer 
network which also includes the Naval Ocean Systems Center 
(NOSC), in San Diego, California, Commander-in-Chief, U.S. 
Pacific Fleet, in Pearl Harbor, Hawaii, and the Fleet Numer- 
ical Oceanographic Center, located in Monterey, California. 
This secure network is referred to as the Advanced Command 
and Control Architectural Testbed (ACCAT), and is certified 
to be able to handle and store classified material up to and 
mieivaing SECRET. A UNIX operating system is resident in 
the C3 Lab’s PDP 11/78, and provides an on-line (time- 
sharing) computing system capability. In addition to ane Ar 
por CRT terminals for entry/retrieval (1/0), the system surp- 
ports color graphics on Genisco display terminals. 

By understanding and taking advantage of the close in- 
teractive relationship between user and computer which is 


engendered by an on-line system, an effective user-oriented 
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program can be realized. To assemble ana collocate such a 
user-oriented program was the primary programming objective. 
To this end, the final criteria used to determine whether 
code was tc be incorporated or rejected in the tutorial and 
decoding program was if the inclusion of some perticular 
code contributed in making the program more user-oriented. 

In the design cof e pregrem where there is a high degree 
of interaction anticipated, perhaps the most important con- 
Sideration is the appearance of the program to the user 
(“the man-machine interface). A program must be appealing 
for a user to want to use it more than once. And if the 
program is to be utilized by a variety of individuals having 
varied levels of expertise or experience, it has to be 
designed and formated in such a manner so that ANY user can 
understand what is expected at each point. Censeauently, 
the more advanced user may have to accept and be tolerant 
c? this possible inconvenience although there are design cp- 
tions that could be incorporated which have the potential to 
alleviate this problem to a great degree. Such ‘human en- 
gineering considerations within a program can be sore of 
the mest time ccnsuming and trcublesome to resolve in creat- 
ing a program. 

There are a number of generally accepted ‘design princi- 
ples. that should be considered when creating a user orient- 
ed interactive program. All the following design principles 


were utilized in the tutoriel and decoding progrenm. 
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(1) Self-explanatory. 

(2) Self-helping. 

(3) Simple interface with user. 
(4) Interaction by anticipation. 
(5) Optional verbosity. 

(6) Echoing 


Althcugh more ‘transparent to a user than those above, 
the following are also considered as necessary elements for 


a truly successful user oriented interactive prcgram. 


(7) The exiting from a program should be a reversible 


request. 


(8) The program should be able to accept direct comment 


from the user. 


(9) The user should never be embarrassed, belittled or 


Chastised. 


Hach one of the abvcve listed design principles is 
described more fully in the following remaining peragraphs. 

A “self-explanatory program is one which presents. the 
user sufficient tutorial information about the program it- 


self to enable the user to proceed without reference to some 





external source of explanation (a separate user’s manuel for 
example). This is accomplished by presenting certain neces- 
Sary and basic items and allcwing the user to opt for addi- 
tional supplementary or tutorial material if desired. 

A “self-helping program provides checking of user in- 
ruts to the program and provides reminders or advisories 
when the user requests help. This is accomplished by check- 
ing the input for validity or reasonableness, and if ap- 
propriate, sending a diagncestic message. This message might 
inform the user that the last entered input is incorrect ei- 
ther in format (usually a typing error), or content. When a 
user specifically reauests assistance, the program should be 
structured to respond in some manner providing the user with 
encugh nelpful infcrmation to resolve, hepefully to the 
user's satisfaction, the apparent predicament the user is 
experiencing. 

“Simple interface with user. is accomplished by ensuring 
that the actions and inputs required by the user ere short, 
simple, and obvious. One aspect of the interface is the 
grouping of options presented within the program. For exam- 
ple, if many options are available, it is probably easier 
for an On-line user to make his choice if the options can be 
Fresé€nted in subgroups of six or fewer items. More than this 
amount can become mind boggling and is, therefore, coun- 


werproductive. 
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“Interaction by anticipaticn is achieved by anticipat- 


ing ell possible desires a user may have and presenting the 
user with choices which include ali of those possibilities. 
This method enables tne user to SELECT (by letter/number/or 
short phrase) rather than SPECIFY (type out in entirely) a 
desired option. 

“Optional verbosity allows for two (or more) levels of 
Metailt to cccur in the interface with the user. For the no- 
fmeemor first-time user, the interface should contain de- 
tailed explanations in order to insure that the user com- 
pletely understands what is expected, and what the program 
is capable of performing. On the other hand, an experienced 
user familiar with the program or subject matter might want 
to choose a mode of cperation witn few or no explanations 
and abbreviated communications (terse messages). A verbosity 
opticn can resolve the problem between presenting too much 
Oreevoo little. 

"Echoing (which could be a verbosity option itself) al- 
lows the user instant feedback in order to verify thet the 
input entered (which may even be used or enacted upon at a 
later time) has been accepted and that it indeed was the 
correct option/input desired in the first place. 

A “reversible request provides the user ‘one last 
chance to consider the consequences of the most recently 
entered action without any dire consequences occurring. In 


the exiting of 2 program, the user is asked if terminetion 
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is actually desired. If termination is indeed desired 
‘reconfirmed;, the user is thanked, and then allewed exit 
(gracefully) from the program. If, on the other hend, the 
user wishes to return to the program and ccntinve, the pre- 
gram returns the user to the point in the program previously 
mocated. 

A program is only useful if it can satisfy a user’s 
needs and requirements. Since many of these desires are not 
peey KnCwn until the user is actually using it, a built-in 
feature to accept keyed in comments, criticism, or sugges- 
tions can be extremely worthwnile. Net cnly will it permit 
the user to vent possible anger, the comments, where feéeasi- 
ble, can be invaluable in developing improvements to the ex- 
isting program thereby enhencing the overall man-machine in- 
terface appearance of the program itself. 

Finally, a program is a tool. If it somehow conveys an 
merroude of “superiority to the user, the user may be in- 
Clined not to employ it. Therefore, a cconscienticus and 
deliberate effort must be made on the part of the creator of 
@ program to treat tne user with respect and courtesy. No 


other approach toward the user can be as effective. 
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ieee nocrar DESCRIPTION 


The graphic tutorial end decoding progrem for Navy Ssig- 
mal flags and pennants that wes created consists of 12 
seperately compiled progrems which have been structured to 
imeeeract with one another. Cemtain values are carried 
between various programs to maintain continuity among all of 
the programs. Memory space limitations during the compile- 
meer Cit a program, and the conscientious effort, in keeping 
with good programming practices, tc modularize the program 
into a number of less cumbersome programs was the rationale 
behint breaking up the program into the id separate pro- 
grams. Any one of the 12 programs can virtually ‘stand 
alone and, therefore, each can be considered as an indepen- 
aqent program. However, these independent programs when dis- 
cussed in this thesis will be referred to es ‘subprograms ; 


wnen the subprograms are considered all together, they make 


up the graphic tutorial and decoding “program . 
A. OVERVIEW 


This program provides a structure designed to assist an 
individual in learning to recognize the Navy signal flags 
end pennants and, secondly, to assist in decoding visual 
flaghoist signals in accordance with the ALLIz£D MARITINS 


TACTICAL SIGNAL EOOK. 
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Pane 2rephics contained in the program ere usec to por- 


MeayecOod display: the twenty-six Internaticnal alphabet 
flags, the ten numeral pennants, and a code/answer fennant; 
a set of the numeral flags; seventeen special flags and pen- 
nants; four substitute pennants; and a tackline or ‘tack’. 
In the tutorial portion, these flags and pennants are shcwn 
individually; in the display/decode portion, they are 
displayed in any number ur to 32 on halyards in order to 
Simvlate signel flégs and pennants es they would be used to 
send a message from a ship. There are also graphics presen- 
taticns which depict the vorogram framework in which the user 
will be working. In each case the user’s present location in 
the program is identified, thereby giving a visual perspec- 
tive of where the user is in relationship to the rest of the 


program. 
Eee OLRUCTURE 


Pees tavGbure Or the program ccnsist of twic main POR- 
TIONS; the tutoriel PORTION, end the displey/decode PORTION. 
Mrestuvorial PORTION has been divided intc three SECTIONS, 
and each SECTION has three SEGMENTS. Each SEGMENT (within a 
tutcrial SECTION; is further subdivided intc either three or 
four grephic tutoriel SESSIONS where the flags and pennants 
are actually presented. The display/deccde PORTION has one 


S:CTION. Figure 1, on the next page, depicts this structure. 
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The Main Selection Level Menu is the center branching 


Point 


within the progrem. It presents the user with six 


choices to choose from. These are: 


INTERNATIONAL ALPHABET FLAGS (TUTORIAL) 
NUMERAL FLAGS AND PENNANTS (TUTORIAL) 
SPECIAL FLAGS AND PENNANTS (TUTORIAL) 
FLAGHOIST DISPLAY/DECODE 

DETAILED PROGRAM DESCRIPTION/DIAGRAM 
QUIT 


Peon iet description of each selection follows. 


(1) 


(3) 


International Alphabet Flags (Tutorial) -- This S£EC- 
TION contains a complete self-contained tutorial, 
which will provide the user a framework to become more 
preficient in the ability to recognize the <6 Interna- 


tional Alphabet flags. 


Numeral Flags and Pennants (Tutorial) -- This SECTION 
contains a complete self-contained tutorial, which 
will provide the user a framework to become more pro- 
ficient in the ability to recognize the i198 Interna- 


tional Numeral pennants and the 1@ Navy Numeral flags. 


Special Flags and Pennants (Tutorial) -- This SECTION 
contains a complete self-contained tutorial, which 


will provide the user a framework to become more pro- 
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(4) 


(5) 


ficient in the ability to recognize 21 special pen- 
nants or flags. The flags and pennants contained are: 
preparative, interrogative and negative (governing 
pennants); emergency, formation, station, turn, cor- 
pen, speed and screen (maneuvering pennants); first, 
second, third and fourth substitutes (repeeter pen- 
nants); starboard (direction pennant); port (direction 
flag); division and squadron (unit indicator flags)} 


and designation pennant and code/answer pennant. 


Flaghoist Display/Decode -~- This SECTION, which is the 
display/decode PORTION of the program, is for the most 
part transparent to the user. It is, however, a Sig- 
nificant part of the program. It allows the user to 
display the flags and pennants that compose a signal 
which is to be sent or received. It also has the ca- 
pability to decode the signal if the display conforms 
to proper flaghoist signaling procedures as delineated 
in the ALLIED MARITIME TACTICAL SIGNAL BOOK. The user 
is advised eae fOr any reason, the present 


flag/pennant arrangement cannot be decoded. 


Detailed Program Description/Diagram -- this selection 
provides the user with a detailed program description 
which appears on the terminal, while simultaneously 
presenting a graphic structure diagram on the color 


screen. This description/diagram is the same option 
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the user is given when first entering the program. It 


is intended to give the user a perspective on the pro- 
gram, what options are available, and the user’s 
current location within the program. This selection 
automatically returns the user to the Main Selection 


Level Menu at the completion of the presentation. 


(6) Quit -- this selection allows the user to quit (exit) 
the program. In fact this is an option that the user 
may opt for at any time when an input is required to 
“advance. the program. However, before being permit- 
ted to actually leave the program, the user is re- 
quested to type in any pertinent comments about any 
aspect cf the program. The quit process is reversible; 
the user will be returned to the same place in the 


program if if he decides not to terminate. 


wena n Gach Of the above first three selections - the 

tutorial PORTION of the pregram - the user is given the 
Choice of selecting one of three SEGMENTS, besides three 
other options. 

TRAINING SEGMENT 

REVIEW SEGMENT 

QUIZ SEGMENT 

BRIEF DESCRIPTION OF SEGMENTS 

RETURN TC MAIN SELECTION LEVEL MENU 

QUIT 
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AmOricLedescription O02 G€ach SaGMENT follows. Where the 


word flag appears it is to mean to be either a flag or a 
pennant. 
(1) Training Segment -- will provide the user with the op- 


(2) 


portunity to learn and study one single flag at a time 
from the flags in the SECTION selected. By presenting 
the user one randomly selected flag at a time along 
with its proper WRITTEN name (except in the case of 
the International Alphabet Flags where the SPOKEN name 
is given), the user can go through the mental process 
of associating a flag with a name. The size or the 
group of flags from which a particular flag is select- 
ed is er Option chosen by the user. A fleg will 
remain on the color screen as long as the user desires 
to have it displayed. The same flag will not appear 
until six other flags have »been presented. Another 
flag automatically appears each time the carriage re- 


burn key is depressed. 


Review Segment -- will allow the user to chocse 
from two options. The first option presents one ran- 
domly selected fleg at a time from the SECTION in a 
Similar manner as in the Training Segment. Howev- 
er, unlike in the Training Segment, the name of the 
flag does not appear simultaneously thereby giving 


the user the opportunity to identify the flag ‘on 
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his own. The correct name of the flag is delayed for 
four seconds. When it appears it essentially 10 ee = 
vides instant feedback to the os either in the form 
of reinforcement if properly identified or of correc- 
tion if wrongly identified. The second option re- 
quires the user to type (enter) the name of the flag 
tiat is desired to be presented on the screen. 
Each time a name is typed the specific flag is 
shown. By entering all’, the user is shown all the 
flags in the SECTION on the screen Simultaneously. 
This $6call up option allows for the flag of 
the user’s own choosing to be shown, thereby provid- 


mgeeeune structure Sor the user to go through the 


mental process of of associating a neme with a flag. 


Quiz Segment -- will present the user with one random- 
ly selected flag at a time from the SECTION. The flag 
will remain on the screen for five seconds and then 
disappear. The user is then required to identify the 
flag by typing in its name on the keyboard. The user 
is informed by an advisory if whet is entered is 
Comrect Or dot. If correct, a new quiz flag is 
presented. If incorrect, the flag will reeppear and 
the user is given another chance to identify it. The 
flag will not disappear after five seconds as before; 


it will remain on the screen until another input by 
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PacmuUScrelomina@e wits tae USer Correctly identifies it, 
an advisory informs the user and a new euiz flag is 
offered. If incorrectly identified, the flag’s nare 
is given and the program then presents the user a new 
flag to identify. The quiz can be terminated at any 
time. When the user ends the auiz, a score in given 
based on the number of correctly identified flags made 
on the initial viewing of the flag. The names of those 
flags that were incorrectly identified after being 


given two opportunities are listed. 
C. INDIVIDUAL SUBPROGRAM DESCRIPTIONS 


By referring to Appendix E a complete description of 
each of the subprograms can be obtained. The Program Sum- 
mary Statement located at the beginning of each subdprogram 
has been extracted directly from each of the source subpro- 
grams and contains a description anda content section. 
The description contains a detailed sequential run-through 
of what each subprogram outwardly presents to the user. The 
Semtent contains a brief outline of the structure which is, 
for the most part, transparent to the user. The content 
section also delineates the subprogram’s relationship(s} 
with other subprograms. 

The complete source code for each of the subpregrams was 
Originally to be included as part of the thesis. However, 


because of the length of some of the subprograms, this in- 
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Clusion was considered és impractical. Access to the code is 
a relatively easy evolution to perform for anyone who wishes 
to cbtain a cepy of any (or all) of the source subprograms. 
Appendix A outlines the necessary procedure to acaguire ac- 
Bess . 

Figure 2, located on the next page, depicts the rela- 
tionships the various subprcegrams nave among one another. 
The titles on the diagram are the compiled progrems” nemes 


as they are actually called. 


or) 





Sweigdgorudqans pattdwog go dtysuotyeroy 


| 1 
sas) ! dye ! spuewwos ! ae Spuewwood | | 
eee ce Uipeerere —pamis| Aore, — re  I ee ae ok ee ee ee | ee 

7 : isToUseTI ! , uTewgns 

ie 

t 

t 

SS | ease] 
qtnb | yezoadstte | ! 
Sey ee ee ee. ae 
| Tepoads ! 

f 

t 

3 ae 1 eee 2k ee cn | 1 
1 1 t 

qtnb ! squnuttTe | |! 
_ Se i ee ee Be See 
| saane 
----- ietseesntenieeed Ga 
q7nb | qeydtet{Te | | 
4 

1 


Suy~otdaq wergetqd “*2 3T¥ 


(quod) getTg |} O1quT } seeps 


ul 





IV. RECOMMENDATIONS FOR FUTURE DEVELOPMENT 





First, although the current program has met the stated 
objective and it has incorporated within it all the design 
features that are considered as necessary tc have a success- 
Meuse r-oriented interactive program, there are several 
“additions which could be included at some later date to 
make it even more appéaling. Second, the current decoding 
portion of the program shows only a “capability 3 it con- 
tains the code necessary to decode only a few of the 
Chapters in ATP 1(B), Vol II. The present capability is 
listed in Appendix C. Last, the entire objective must be 
examined in the context of cost versus value , and a deter- 
Minetion must be made whether the pursuit of a fully opere- 
tional product is a worthy endeavor. 

The envisioned long range application for the program is 
to install such a program onboard a naval vessel for at-sea 
use. Hardware necessary to support the program would, by 
necessity, most likely have to be reduced to a desk top. 
Comevesuration with the possibility of running several remote 
graphic CRT’s, if graphics were desired; and a hand calcu- 
lator configuration if graphics were not particularly 
necessary. The program would be used when a vessel was re- 
ceiving a flaghoist (or flashing light or semaphore) mes- 


sage. The duty signalman would enter the flags on @ keyboard 
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as they are visually read. After entering the flags which 
make up the signal, the user merely has to type ‘decode’, 
verify or confirm that the flags are the ones sent, before 
reading the meaning of the signal on a screen (CRT) or ina 
window. The Commanding Officer and/or Officer of the Deck 
could also be previded with a remote CRT so that the message 
could be instantaneously delivered to the ultimate intended 
receiver. The tutorial portion of the program would be util- 
ized onboard ship to keep proficiency high in recognition of 
the flags, and on shore at those installations where signal 
flag training is a requirement (for example, Signalman ‘A™ 
Scheol, Officer Candidate Schcol and Surface Warfare Officer 
School). | 
One of the additions that would make the program more 
appealing would be to reduce and/or convert the present pro- 
gram, which is dependent on the PDP 11/73 and Genisco, to 
one which fits into a microcomputer with a graphics capabil- 
ity or into (smaller still) a pocket translator/calculator 
size device without a graphics capability. Putting the pro- 
gram (excluding the graphics capability for the present 
time) on a chip so that it could be then easily updated 
_end even encrypted when necessary in order that it then 
could be put into some small hand held device is the ulti- 
mate goal. To speed the precess between reading the flegs 
and being presented the meaning, voice input of the flags 


possibly could be added. In any case, memory space and s12ze 
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studies would have to be conducted on the feasibility of any 
of the above configurations before the present program could 
be made more readily available to its potential users in the 
Fleet. 

Before the program can be considered completely ready 
for evaluation and use, the decoding portion of the program 
must be finished. Presently, the progrem can only claim to 
demonstrate the capability. The author, however, has care- 
fully selected those chapters thus far incorporated in the 
program as representative of the remaining material in ATP 
1(B), Vol II. For this reason there does not appear to bde 
anything more intricate to program than what has already 
been done. Memory space May become a limitaticn, but this 
should not be difficult to overcome on the PDP 11/7@. 
Research into possibly a better method and/or language to 
code this portion of the program could lead to a program 
mone efficient overall. 

A premise of this thesis was that the stated obdjective 
was worthy enough to develop an alternate approach in order 
to satisfy it. Now that an alternative has been developed, 
the user community should be approached to see if such a 
product has real “user appeal. If it is well received, 
Mabe another major hurdle must be overcome. That hurdle is 
cost. The present system for learning the flags and pen- 
nants used in flaghoist, and decoding (and encoding) 


Plaghoist displayed signals ccnsists of a pack of €8 flasn 
{ 
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Cards and one formidable publication. What is proposed to 
replace these items would require a rather sophisticated, 
though easy to operate, piece of computer equipment. 
Although the cost of such equipment is decreasing continu- 
ously, it may still be too high to make it practical. A cest 
versus value study would have to be conducted before further 
substantial time investments are devoted to actually writing 
the decoding code. It is the opinion of the author after 
Studying the matter, that the tutorial and decoding preduct 
is beneficial from the user’s standpoint, but that its mone- 
tary cost may be prohibitive at this time. 

The final improvement that is recommended would be to 
create, design and develop a natural language ENCODE coun- 
terpart to the decode portion of the program. This would be 
a formidable undertaking but great strides have been made 
recently in natural language query routines and systems. 
mameoOr the techniques derived could be applicable in 


developing an efficient encoding scheme. 
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APPENDIX A 
PROGRAM OPERATING INSTRUCTIONS 


An individual desiring eitner to view the scurce code or 
run the Graphic Tutorial and Decoding Program for Navy Sig- 
nal Flags and Pennants must first place the program’s 
source and object files into his/her directory. This is ac- 
complished by making the necessary arrangements to or fol- 
lowing the procedures for mounting a magnetic tape labeled 
"FLAGS , which is stored in the C3 Lab in the custody of the 
manager of the C3 Lab. 

To run (execute) the tutorial and decoding PROGRAM, cnce 
all the subprogrems are loaded/transferred into the user’s 
directory, the sutprogram flag should be initially called. 
"Flag is the only subprogram which offers the user a choice 
of Genisco screens which can be activated, and which allows 
the user to choose ancther section of the program in which 
to go. If called first, all other subprograms will automati- 
cally default to Genisco screen @ (left bay screen in the 
C3 Lab). Moreover, when in certain subprograms the command 
“main is entered--which is required prior to being able to 
select another section--the subprogram will exit automati- 
Cally and return ane user back to the UNIX executive shell 


level unceremonfously and without any advance warning. 
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Once flag’ is called, the user should be able to util- 
ize the program as long as desired. The pregram was inten- 
tionally designed and structured to stand alone (i.e., to 
be self explanatory) and does not require any user’s manual. 
meee user does encounter a situation which is seemingly 
ambiguous or confusing, entering help or “? will provide 
an advisory which will delineate the ortions available to 
meetin the situation. The user must, however, nave some 
knowledge of flaghoist procédures and terminology to derive 
maximum benefit ?rom the decoding section of the prcgram. No 
other operator instructions should have to be given to the 
prospective user before beginning the program. 

The program is self-helping and uses simple interface 
commands. The user has the cpportunity to view detailed in- 
structions and a graphic diagram describing the entire pro- 
gram just after entering the program. If the user opts not 
to see these, he can bypass them and go directly into the 
Main Selection Level Menu (MSIM); however these instructions 
are always availeble to the user as one of the options in 
the MSLM. 

The prcegram employs the techniaues of interaction by an- 
ticipation since the commands required to progress through 
the program are the characters corresponding to the correct 
name of the flag or pennant. The remaining commands ere 
consistent in their meaning throughout the program, and 


Should not be ambiguous to even the novice user. 


Oo” 





The program contains defaults in case the user mistyrpes 
an input. If the input is not immediately acted upon, the 
program will echo the user’s entry. Within the decoding 
portion of the program there is a verbosity option which al- 
lows the user to tailor the amount of information received 
after an entry is made. There are three different verbosity 
levels to choose from. 

The program allows the user to quit and exit the program 
from any point but reeuires the user to verify his intention 
to quit before the program helts and returns to the UNIX 
shell command level. Prior to quitting, the user is re- 
quested to enter any comment(s) that may be considered ap- 
propriate. 

In order to monitor the utility of the progrem, code hes 
been incorporated within two of the subprograms which will 
record time of user entry and exit, along with any comments 
that the user makes when quitting the program. These subd- 
programs will have to be modified if someone (other than the 
author) would like this information. Subprograms “flag.c_ 
and quit.c have been documented sufficiently to permit 
someone else to do this. 

All the subprograms are written in the “c. language. A 
basic understanding of ‘c is necessary if the reader in- 
tents to medify the subprograms themselves. A conscientious 
effort was made to provide detailed documentation along with 


each subprogram. 
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All the subprograms were compiled using the compiler 
command kec . For example, to compile the subprogram 
“flag.c (all programs must have a filename of the form 
“(filename).c ) the shell command “kec (filename) is en- 
tered followed by a carriage return. -kcce is a fileneme 
itself containing the following compiler command calls: 

cc $1.c /usSr/graphics/genlib.a 
/usr/graphics/genlib.a /usr/graphics/genlib.a 


This compiler allows more streamlined graphics commands to 


be used in the Genisco source code. 
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APPENDIX 8B 
SUBPROGRAM SUMMARY STATEMENTS 


PROGRAM: flag.c 
PROGRAM SUMMARY STATEMENT 


DESCRIPTION: THE INITIALLY CALLED PROGRAM FOR THE NAVY 
SIGNAL FLAGS aND PENNANTS PROGKAM. 


USER IS GREETED TO PROGRAM ON THE CRT, AND REQUESTED TO 
AUTOMATICALLY WITH SOME BASIC PROGRAM REMINDERS. FOLLOWING 
THIS THE USER IS GIVEN A CHOICE OF WHAT GENISCO SCREEN IS 
TO BE UTILIZED. AFTER THIS HAS BEEN DETERMINED AND THE 
SELECTION ECHOED, TEE PROGRAM THEN PRESENTS TO USER TEE 
FORMAL INTRODUCTION TC THE PROGRAM ON THE GENISCO SCREEN, 
FOLLOWED BY AN OVERVIEW OF THE OBJECTIV=S OF THE PROGRAM ON 
THE CRT. THE USER IS THEN ASKED IF A MORE DETAILED 
DESCRIPTION OF THE PROGRAM — WITH A GRAPHIC DIAGRAM - IS 
DESIRED. IF THE USER SELECTS THIS OPTION A SIX PAT 
SIMULTANEOUS CRTI/SCREEN DESCRIPTION/DIAGRAM PRESENTATION IS 
PROVIDED. THE USER CARRIAGE RETURN KEY. AT TEE END OF TEIS 
OPTION THE USER IS AUTOMATICALLY PRCVIDED WITH THE MAIN 
SELECTION LSVEL MENU (MSLM) WHERE EE MAY MAKE ONE OF SIX 
CHOICES. IF THE USER DID NOT SELECT THE DESCRIPTION/DIAGRAM 
CPTION, THE MSLM IS PRESENTED IMMEDIATELY AFTER THE POINT 
WHERE WEEN THE USER INDICATED THAT TEE OPTION WAS NOT 
DESIRED. 


CONTENTS: TRANSPARZNT TO THE USER WHEN SIGNING-IN IS THAT 
THE NAME BEING ENTERED IS AUTOMATICALLY BEING PLACED IN A 
FILE CALLED “INPUT” IN A DIRECTORY PRESENTLY WITEIN ‘BIEN’. 
[NOTE:THE “PROGRAM MONITOR’ WILL HAVE TO INSURE 

THAT AN “INPUT” FILE IS MAINTAINED IN HIS/HER DIRECTORY AND 
THAT flag.c IS PROPERLY MODIFIED TO HANDLE THIS. THIS ALSO 
MUST BE DONE IN THE quit.c SUBPRCGRAM.] wWHEN THE CARRIAG2 
RETURN IS TYPED THE CURRENT TIME IS ALSO PLACED IN THE 

FILE “INPUT’ UNDER THE HEADING OF ‘TIME LOGGED IN:”’ THIS 
FILE “INPUT’ HAS BEEN CREATED IN ORDER TO MONITOR USE OF 
THE PROGRAM, AND ALSO--MORE IMPORTANTLY--AS AN RECEPTACLE 
FOR USER INPUT COMMENTS WHICE ARE SCLICITED WHEN THE USZR 
INDICATES THAT HE DESIRES TO ‘QUIT’ (EXIT) THE PROGRAM. 
(SEE quit.c PROGRAM FOR MORE DESCRIPTION OF THIS OPTION.) 
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Peeeencoant sD) EFFORT HAS BEEN MADE IN ORDER TO MAKE THE 
PROGRAM WHERE “AUTCMATIC ADVANCEMENT’ OF THE PROGRAM IS NOT 
PRESENT. IN OTERER WORDS, EVERYWHERE TEAT TEE USER MUST 
PPPRSIN SOME ENTRY - BE IT EVEN A CARRIAGE RETURN - AND AN 
ERRONEOUS ENTRY IS MADE INSTEAD OF THE ONE (OR CNE FROM THE 
GIVEN SELECTION) PROMPTED FOR, AN ADVISORY WILL BE GIVEN 
INFORMING THE USER THAT WHAT WAS JUST TYPED/ENTERED WAS NOT 
ACCEPT#D AND THAT ANOTHER INPUT IS NECESSARY TO CONTINUE 
TEE PROGRAM. THERE ARE ALSO ADVISORYS PROVIDED IF THE USEP 
GETS “CONFUSED” OR “LOST” AND TYPES °?° OR 


THE PROGRAM AUTOMATICALLY FCRKS TO (AND RETURNS FROM) 
intro.c AFTER SCREEN SELECTION KAS BEEN DETERMINED. TES 
PROGRAM FORKS TO alphab.c IF INTERNATIONAL ALPEARET FLAGS 
SELECTED; TO numbs.c IF NUMERAL FLAGS AND PENNANTS 
SELECTED; TO special.c IF SPECIAL FLAGS AND PENNANTS 
SpmectTeED; TO submain.c IF FLAGHOIST DISPLAY SELECTED; TO 
quit.c IF QUIT SELECTED; CR TO THE SUBROUTINE Descr({) IF 
THE USER WANTS TO REVIEW THE DESCRIPTION/DIAGRAM 
PRESENTATION OPTION AFTER VIEWING THE MAIN SELECTION LEVEL 
MENU. 


PROGRAM: intro.c 
PROGRAM SUMMARY STATEMENT 


DESCRIPTION: PROVIDES THE OPENING GRAPEICS FOR THE NAVY 
SIGNAL FLAGS AND PENNANTS PROGRAM. DISPLAYS FLAGS WEICH 
SPELL CUT IN CLEAR TEXT “NAVY FLAGS AND PENNANTS” FOLLOWED 
BY WRITTEN TITLE OF PROGRAM AND AUTEOR’S NAME. 


CONTENTS: CALLED AUTOMATICALLY BY flag.c, AND RETURNED 
AUTOMATICALLY TO flag.c. CONTAINS NO OPTIONS. ENTIRE 
SUBPROGRAM IS NON-INTERACTIVE. (SUGGEST TEIS SUBFROGRAM EE 
FYPASSED WHEN ACCESSING flag.c A NUMBER OF TIMES WEIL? 
PERFORMING ANY SORT OF MAINTENANCE. SEE Plag.c AT FORK TO 
TEIS SUBPROGRAM FOR SUBSTITUTE CODE FOR BYPASSING THIS 
SUBPROGRAM. ) 
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PROGRAM: alphabd.c a em oOminumos ac) AND. 1special.c})*** 
PROGRAM SUMMARY STATEMENT 


DESCRIPTION: BY SELECTING THIS OPTION THE USER DESIRES TC 
LEARN/STUDY THE INTERNATIONAL ALPHABET FLAGS (26) [THE 
NUMERAL FLAGS (12) AND PENNANTS (18)] {THE SPECIAL FLAGS 
AND PENNANTS (21)}. 


THE USER IS PROVIDED WITH A SECTION MENU WITH CHOICE OF 
FOUR MAIN OPTIONS (BESIDES CAPABILITY TO QUIT AND TO RETURN 
TO THE MAIN SELECTION LEVEL MENU (MSLM)), DEPENDING ON WHAT 
SEGMENT (TYPE OF FLAG PRESENTATION) IS DESIRED. TEE 
TRAINING SEGMENT PROVIDES ONE SINGLE RANDOM FLAG WITH ITS 
CORRECT NAME SIMULTANEOUSLY; REVIEW SEGMENT PROVIDES TWO 
MAIN OPTIONS WITHIN ITSELF: (1) A RANDOM FLAG DISPLAYED 
WITH FOUR SECOND DELAY CF THE FLAG’S NAME, (2) FLAG 
DISPLAYED WITH NO NAME (FLAG NAME TYPED ON KEY BOARD TO 
CALL FLAG TO SCREEN.) OR BY ENTERING SCREEN TOGETHER; AND 
GUIZ SEGMENT WHICH PRESENTS A RANDOM FLAG AND USER MUST 
PROVIDE NAME. A SCORE IS MAINTAINED IN THIS SEGMENT. THE 
FORTE OPTION PROVIDES USER WITH A BRIEF DESCRIPTION OF EACE 
OF TEE SEGMENTS FOR USER’S PERUSAL. WITHIN THE TRAINING AND 
QUIZ SEGMENTS THERE ARE THREE TUTORIAL SESSIONS; WITHIN THE 
REVIEW SEGMENT TEERE ARE FOUR SESSIONS. THE FIRST SESSION 
WITHIN ANY OF THE SEGMENTS DISPLAYS A RANDOM FLAG FROM ONE 
HALF OF ALL THE FLAGS IN THE SECTION (A-M [2-9] {1@ SPECIAL 
PENNANTS}), THE SECOND SESSION WITHIN ANY OF THE SEGMENTS 
DISPLAYS A RANDOM FLAG FROM THE REMAINING FLAGS IN THE 
SECTION (N-Z [p@-p9] {11 SPECIAL PENNANTS}) AND THE THIRD 
SESSION TAKES A RANDOM FLAG FROM THE ENTIRE GROUF OF FLAGS 
AVAILABLE (A-Z [2-9 & pO-p9] {21 SPECIAL PENNANTS}). THE 
FOURTH SESSION WITHIN THE REVIEW SEGMENT ALLOWS THE USER TO 
DISPLAY ANY FLAG OF TEE USER‘’S OWN CEOOSING, OR ALL TEE 
FLAGS TOGETHER. 


MemleNTIS: THERE ARE NO LIMITATIONS TO A TUTORIAL SESSION; 
WHEN THE USER DESIRES TO TERMINATE A SESSION ALL TEAT IS 
REQUIRED IS ‘end’ TO BE ENTERED. THE USER WILL BE RETURNED 
mes oeCTION MENU AT THE END OF EVERY SESSION. THE USER MAY 
feeeN LTO TEE MSLM OR QUIT FROM EITEER A SESSION OR AT TEE 
SZCTION MENU LEVEL. HOWEVER, ONCE A SEGMENT HAS EZEN 
mooeoleD, THE USER IS NOT PERMITTED TO RETURN TO THE MSLM 
OreeeUll UNTIL THE USER IS WITHIN A TUTORIAL SESSION. 
CALLED FROM flag.c MAIN SELECTICN LEVEL MENU WITH INPUT ‘a’ 
men 4s +. FORKS TO allalphat.c [allnumbs.c] 
{allspecial.c} IF USER SELECTS COMMAND ‘all’ IN THE CALL UP 
OPTION OF REVIEW SEGMENT. FORKS BACK TO flag.c WITH ‘main’; 
TO quit.c WHEN “quit” ENTERED. 
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PROGRAM: allalphab.c 
** (ALSO [Lallnumbs.c] AND {allspecial.c} })** 


PROGRAM SUMMARY STATEMENT 


Mimi rtiON: DISPLAYS TO THE USER ALL THE 26 [20] {21} 
FLAGS/PENNANTS IN THE SECTION ON THE SCREEN AT ONE TIME. 


CONTENTS: CALLED FRCM alphabd.c [numbds.c] {special.c} WITH 
INPUT SUBPROGRAM WHEN ALL FLAGS/PENNANTS ARE DISPLAYED. 
CONTAINS NO OPTIONS. ENTIRE SUBPROGRAM IS NON-INTERACTIVE. 


PROGRAM: submain.c 
PROGRAM SUMMARY STATEMENT 


DESCRIPTION: GREETS USER TO DISPLAY/DECODING PORTION OF 
PROGRAM. PROVIDES USER INPUT REMINDERS AND THEN PRESENTS 
THE CURRENT DECODING CAPABILITIES BUILT INTO THE PROGRAM. 
THS USER IS THEN GIVEN THE OPTION TO CHOOSE FROM THREE 
LEVELS OF VERBOSITY. NEXT THE USER IS GIVEN THREE OPTIONS 
FROM WHICH TO CHOOSE WHAT FLAGHOIST DISPLAY CONFIGURATION 
IS DESIRED. THE FINAL OPTION PROVIDES THE USER, IF CHOSEN, 
WITH ALL THE VARIOUS KEYSTROKE COMMANDS (OTHER THAN 
FLAG/PENNANT NAMES) WHICH WILL BE ACCEPTED. 


CONTENTS: (THIS SUBPROGRAM PRIMARILY WRITTEN BECAUSE OF 
MEMORY SPACE LIMITATICNS IN flaghoist.c.) SUBPROGRAM 
PROVIDES STRUCTURE FOR INTRODUCTION TO DISPLAY/DECODING 
PORTION. BOTH VERBOSITY AND DISPLAY CHOICES ARE ECHOED. 
DEPENDING ON WHAT VERBOSITY SETTING CHOSEN, SOME ADVISORY 
INFORMATION EITHER PROVIDED OR OMITTED. 


CALLED FROM flag.c MAIN SELECTION LEVEL MENU WITE IN- 

PUT “fh” (FLAGHOIST). FORKS TO commands.c IF USER SELECTS 
COMMAND OPTION; FORKS AUTOMATICALLY TO flaghoist.c AT END. 
FORK OPTION TO quit.c AND flag.c (AT MSLM) AVAILABLE AT 
CERTAIN POINTS. 
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FROGRAM: flaghoist.c 
PROGRAM SUMMARY STATEMENT 


DESCRIPTION: PROVIDES USER WITH CURRENT VEREOSITY AND 
DISPLAY SETTINGS. INFORMS USER TEAT FLAGS MAY BEGUN TO BE 
DISPLAYED. ALLOWS USER TO TYPE IN ANY FLAG OR PENNANT BY 
NAME AND DISPLAYS FLAG OR PENNANT ON A SIMULATED HALYARD OF 
THE USER’S CHOOSING IN FLAGHOIST ORDER. USER MAY 
CHANGE/MODIFY FLAGS DISPLAYED BY USING APPROPRIATE COMMANDS 
PROVIDED FROM THE “’COMMANDS” LISTING. WHEN THE USER HAS THE 
SIGNAL DISPLAYED ON THE SCREEN WEICH EE WANTS TO HAVE 
DECODED, THE COMMAND ‘decode’ IS ENTERED. TEE PROGRAM 
RETURNS THE NAME OF THE FLAG(S) AND ITS (THEIR) FLAG 
POSITION(S) FOR THE USER TO CONFIRM, BEFORE ATTEMPTING TO 
DECODE THE SIGNAL. MFANING OF SIGNAL IS NATO CONFIDENTIAL 
WHEN ARRANGEMENT OF FLAGS AND MEANING ARE ASSOCIATED. 


CONTENTS: CALLED FROM submain.c AUTOMATICALLY WEEN 
submain.c ENDS. FORKS TO commands.c WHEN EITEEFR “commands” 
OR “help” ENTERED; AUTOMATICALLY RETURNED AFTER COMMANDS 
ARE PRESENTED ON CRT. ACCEPTS ANY CORRECT FLAG NAME OR 
COMMAND AND EITHER DISPLAYS FLAG OR EXECUTES COMMAND. FORKS 
TO atp.c SUBPROGRAM IF USER SO INDICATES A DESIRE TO KNOW 
fee DISPLAYED FLAGHOIST SIGNAL IS VALID I.E., HAS A 
MEANING. ALLOWS USER TO LCOP AS MANY TIMES AS DESIRES; WHEN 
USER CHANGES DISPLAY CPTION ALL FLAGS ARE REMOVED; DISPLAY 
OPTION TWO (“disp2’) NOT CURRENTLY AVAILABLE DUE TO MEMORY 
SPACE/COMPILE CONSTRAINTS. FORK OPTION TO quit.c AND 
tiee.c AT THE MSLM AVAILABLE AT ANY TIME. 


NOTE TO ADVANCED USERS OF THE PROGRAM: BY TYPING “fleg- 
hoist’ FROM THE UNIX SHELL LEVEL, THIS SUBPROGRAM CAN 

BE ACCESSED DIRECTLY WITHOUT HAVING TO GO THROUGH TEE MSLM 
(flag.c) OR THE DISPLAY/DECODING PORTION INTRODUCTION 
(sutmain.c). HOWEVER, IF THE VERBOSITY AND DISPLAY 
SETTINGS ARE NOT IMMEDIATELY CHANGED TO VALUES THAT ARE 
RECOGNIZED BY THE PROGRAM, THE SUBPROGRAM WILL NOT FUNCTION 
IN A STAND ALONE CAPACITY. REMEMBER, THIS SUBPROGRAM WILL 
ONLY OPERATE IN THIS MODE AT TEE LEFT BAY SCREEN IN THE CS 
LAB BECAUSE OF THE DEFAULT TO GENISCO -@ WHICH OCCURS WHEN 
NOT INITIALLY GOING THROUGH flag.c. 





PROGRAM: commands.c 
PROGRAM SUMMARY STATEMENT 


DESCRIPTION: LISTS ALL THE COMMANDS AVAILABLE FOR MODIFYING 
DISPLAYED FLAGS, CR FOR CHANGING VEREOSITY LEVEL AND 
DISPLAY CONFIGURATION. 


CONTENTS: CALLED BY submain.c OR flaghoist.c. RETURNS TO 
CALLING SUBPROGRAM WHEN CARRIAGE RETURN (OR ANY OTHER 
INPUT) ENTERED; NO OTHER OPTIONS ARE AVAILABLE. 


PamatAMs atp.c 
PROGRAM SUMMARY STATEMENT 


DESCRIPTION: PROVIDES THE USER WITH TEE MEANING OF TEE 
DISPLAYED FLAGS/PENNANTS ON CRT. 


CONTENTS: ALMOST ENTIRELY TRANSPARENT TO THE USER, THIS 
SUBPROGRAM CONSISTS OF ONE VERY LARGE ‘IF’ LOOP WHICH 
ATTEMPTS TO SEARCH FOR A MATCH BETWEEN WHAT IS IN THE FIRST 
ONE TO FOUR FLAG POSITIONS WITH A “DATA BASE’ CONSISTING OF 
BASIC GROUPS EXTRACTED FROM ATP 1(B), VOL II. WEEN A 

MATCH OCCURS THE MEANING IS PRESENTED AND THE SEARCH 
CONTINUES USING THE NEXT GROUP. A GROUP IS DEFINED AS AN 
ARRAY OF THOSE UNICGUE FLAG NUMBERS UP TO BUT NOT INCLUDING 
A TACK (6&) OR A SPACE (0). TACKS AND SPACES ARE 
DISREGARDED BUT ARE USED AS END OF ARRAY AUTOMATICALLY TO 
flaghoist.c AFTER ALL FLAG NUMBERS HAVE BEEN SEARCEED FOR 
AND MEANING HAS/HAS NOT BEEN FOUND AND PRESENTED ON THE 
SCREEN. IF NO MATCH IS FOUND, AN ADVISORY INFORMING THE 
USER OF THIS IS PRESENTED. 


THIS SUBPROGRAM IS NATO-CCNFIDENTIAL AND SHOULD EE ACCORDED 
THE PROPER SECURITY FOR SUCH A CLASSIFICATION. 





PHeGrkAM:s @euit.c 
PROGRAM SUMMARY STATEMENT 


DESCRIPTION: REQUESTS THE USER BEFORE TERMINATING THE 
PROGRAM TO TYPE IN ANY COMMENTS THAT ARE DEEMED 
APPROPRIATE. IF THE USER WISHES NOT TO COMMENT, (S)BE THEN 
MAY EXIT DIRECTLY. IF THE USER DESIRES TO RETURN TC THE 
PROGRAM, (S)HE ENTERS “ret” AND IS REINSTATED AT THE SAME 
LOCATION IN THE PROGRAM AS BEFORE. 


CONTENTS: PRESENTS A GRAPHICS “TO WARN” USER THAT THE END 
OF THE PROGRAM MAYBE NEAR. IF USER INDICATES THAT (S)HE 
WISHES (WILLING) TO MAKE SOME COMMENTS, THE “INPUT” FILE IS 
OPENED TCO RECEIVE ENTRIES UP TO EIGHT LINES IN L&NGTH;s TIME 
OF EXIT ALSO ENTERED. IF THE USER INDICATED THAT NO 
COMMENTS ARE WANTED TO BE MADE “INPUT” OPENED TO RECORD 

si SnD ee AND AUTOMATIC ENTRY OF “NO COMMENT’. (SEE ALSO 
fede C 


CALLED BY flag.c, alphab.c, numbs.c, special.c, submain.c, 
OR flaghoist.c. RETURNS TO CALLING SUBPROGRAM WHEN ‘ret’ 
ENTERED. ALLOWS USER TO “EXIT GRACEFULLY” FROM TEE PROGRAM. 
PROCESS IS REVERSIBLE. 


SINCE RETURNING TO THE UNIX SHELL COMMAND (TEE REAL 
INTERPRETATION OF QUITTING) CAN ONLY BE ACCCMPLISHED BY 
EXITING OUT THROUGH THE INITIALLY ENTERED PROGRAM, A 
PROSESS WAS DEVISED TO “BACKTRACK”’ TEROUGE THE VARIOUS 
SUBPROGRAMS FORKED INTO. THIS WAS ACCOMPLISHED BY CARRYING 
A VALUE IN THE “’exit’ ARGUMENT. A PRIOR TO ENTERING THE 
quit.c SUBPROGRAM; A “1° (ONE) VALUE WOULD RETURN ALL THE 
WAY PACK TO flag.c WHERE IT THEN WOULD RETURN TO THE UNIX 
SHELL. (SEE ADDITIONAL DOCUMENTATION WITHIN SUBPRCGRAM.) 
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APPENDIX C 


CURRENT PROGRAM DECODING CAPABILITY 


The following is extracted directly from the submain.c 
Subprogram and lists the current decoding capability of the 
program. 

PRESENTLY INCORPORATED IN THE DECODING PORTION OF THE 
PRCGRAM ARE THE FOLLOWING CHAPTERS, ARTICLES, PARAGRAPHS 


PROM ATP 1(B), VOL II. (AS OF 15 MAR 81) 
juabal GOVERNING PENNANTS 
2 GOVERNING GROUPS 
iS PLAIN TEXT (NOTE 1) 
122 UNITS OF REFERENCE (partial) (NOTE 1) 
123 FRACTIONS (NOTE 1) 


124a,C TIMES 
126b,c BEARING AND DIRECTION/DISTANCE (NOTE 1} 
128a,b,c METHOD OF ORDERING SECTORS (NOTE 1) 


S@1 EMERGENCY EXECUTE SIGNAL 
OZ EMERGENCY ALARM SIGNALS 
OOS EMERGENCY ACTION SIGNAIS 
1601 ANTIAIR WARFARE SIGNALS 


NOTE 1:WHERE APPLICABLE IN SIGNALS EXTRACTED FROM CHAPT S-3c. 
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